home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 30 / Amiga Format AFCD30 (Sep 1998, Issue 114).iso / -seriously_amiga- / graphics / mnu² / mnu-2 / mnu².doc next >
Text File  |  1998-06-18  |  8KB  |  263 lines
  1.  
  2. Mnu²(1)                     USER MANUAL                        Mnu²(1)
  3.  
  4.  
  5. NAME
  6.  
  7.      Mnu² - manipulates realtime one or two animations on screen.
  8.  
  9. AUTHORS
  10.  
  11.      Rob Haarsma, with help from Harro Mantel.
  12.  
  13. VERSION
  14.  
  15.      Version 2.5.1 of Mnu² completed 29 Januari 1998
  16.  
  17.      Compiled on a Amiga 2000 with SAS/C Amiga Compiler 6.00,
  18.      while listening to Tackhead Power Inc. Volume 3 (Live).
  19.  
  20. PUBLISHER
  21.  
  22.      © 1994-98 by TNCCI Inc. All Rights Reserved.
  23.      Distribution of Mnu² is NOT prohibited.
  24.  
  25. INSTALL
  26.  
  27.      Decompress the archive and copy the required Mnu² version from
  28.      the cpu-named directories in the directory containing Mnu².info
  29.      and the Mnu².doc file.
  30.  
  31. SYNOPSIS
  32.  
  33.      Mnu² - activate icon from Workbench.
  34.  
  35. DESCRIPTION
  36.  
  37.      Mnu² displays one (single) or two (mixed) ANIM-5 files on the
  38.      screen. While playing, the user can move the images realtime
  39.      with the mouse. The user can also modify the appearance of
  40.      the images with the use of several buttons on the keyboard.
  41.      There are many different combinations possible, play around to
  42.      get the best results. (Read the Quick Start chapter !)
  43.  
  44. RESTRICTIONS
  45.  
  46.      Mnu² operates with 2, 4, 8, 16 and 32 color animations that are
  47.      created with ie. DeluxePaint4.6 (or less). When you're working
  48.      with two animations, make sure that both size and number of
  49.      colors are the same. Needless to say that the best performance
  50.      is retreived by a minimum of colors.
  51.  
  52.      If the ANIM-5 file contains AGA or 256 color information, Mnu²
  53.      will cause graphical artifacts that'll result in a system-crash.
  54.      The authors hope to solve this problem in a future version. For
  55.      now you can load and save the animation in DeluxePaint4.6 to get
  56.      rid of the AGA rubbish.
  57.  
  58. OPERATORS
  59.  
  60.      Mouse motions
  61.          Scrolls the images over the screen. With two animations
  62.          the second animation will move the opposite way.
  63.  
  64.      Z  (default)
  65.          The scrolling motion is equal to the mousemovements.
  66.      X
  67.          The scrolling motion accelarates with the mousemovements.
  68.      C
  69.          The scrolling motion will continue forever.
  70.  
  71.      1, 2, 3, 4, 5, 6, 7, 8, q, w, e, r, t, y
  72.          These buttons determine the mix mode of the animations.
  73.          They represent all sorts of logical operations to combine and
  74.          merge the bitplanes of the animations. Use them as you like.
  75.          With one animation 5 is default, with two 1 is the default.
  76.  
  77.      TAB
  78.          Select a (one of ten) wipe pattern, only visible when F1 is
  79.          activated.
  80.  
  81.      Backspace
  82.          Saves the on screen image as an IFF picture to ram disk.
  83.          Multiple savings are called mnusession.000, mnusession.001,
  84.          etc.
  85.  
  86.      Arrow Keys
  87.          Move the complete screen.
  88.  
  89.      Numeric Pad +
  90.          Increases the animation tempo.
  91.  
  92.      Numeric Pad -
  93.          Decreases the animation tempo.
  94.  
  95.      Numeric Pad 2, 4, 6, 8
  96.          Move the mouse 1 pixel.
  97.  
  98.      Numeric Pad 0
  99.          Resets all modifiers. Favourite button for newcomers !
  100.  
  101.      Escape
  102.          Quits Mnu².
  103.  
  104. MODIFIERS
  105.  
  106.      All following buttons operate as toggles. Press once means ON,
  107.      press again and it's OFF.
  108.  
  109.      Mousebuttons, Spacebar
  110.          Freezes the first animation.
  111.  
  112.      f
  113.          Activates digital feedback when using two animations.
  114.  
  115.      F1
  116.          Wipes the images when moving the mouse, according to the
  117.          selected wipe-pattern. (use TAB button to select pattern).
  118.      F2
  119.          Shears the images when moving the mouse.
  120.      F3
  121.          Displays a quarter of the screen 4 times.
  122.      F4
  123.          Performes a x and y mirroring of a quarter of the screen.
  124.      F5
  125.          Enlarges the upper halve of the screen.
  126.      F6
  127.          Performes a Y mirror.
  128.      F7
  129.          Performes a X Mirror. (slow due to binary restrictions)
  130.      F8
  131.          Performes a slow rotation of the mouse.
  132.      F9
  133.          Performes a fast rotation of the mouse.
  134.      F10
  135.          Swaps between the color palettes of the animations.
  136.  
  137.      Del
  138.          Swaps automatically between palettes.
  139.      Help
  140.          Swaps automatically (without mixing) between animations.
  141.  
  142.      Numeric Pad (
  143.          Locks x scrolling.
  144.      Numeric Pad )
  145.          Locks y scrolling.
  146.  
  147. BITPLANE OPERATORS
  148.  
  149.      The following operators allow you to move the image's bitplanes
  150.      separately. Their functionality depends on the number of colors
  151.      of the animation(s).
  152.  
  153.      '
  154.          Lock bitplane #1 (works with 2 or more color animations)
  155.      [
  156.          Unlock bitplane #1
  157.      ;
  158.          Lock bitplane #2 (works with 4 or more color animations)
  159.      p
  160.          Unlock bitplane #2
  161.      l
  162.          Lock bitplane #3 (works with 8 or more color animations)
  163.      o
  164.          Unlock bitplane #3
  165.      k
  166.          Lock bitplane #4 (works with 16 or more color animations)
  167.      i
  168.          Unlock bitplane #4
  169.      j
  170.          Lock bitplane #5 (works with 32 color animations)
  171.      u
  172.          Unlock bitplane #5
  173.  
  174. ENVIRONMENT
  175.  
  176.      Mnu² will hold the current animation filename in ram:mnu².fnc.
  177.      If this file is missing, it will use Work: as the current path.
  178.  
  179. QUICK START
  180.  
  181.      Here are a few tricks to figure out how Mnu² really works...
  182.  
  183.      - Load one animation, press F1, move the mouse a bit, and walk
  184.      through the 10 different wipe patterns by pressing TAB. Keep
  185.      moving the mouse to control the effect. Deactivate the wipe
  186.      by pressing F1 again.
  187.  
  188.      - Load one animation, press C, move the mouse, press F4 and
  189.      watch Mnu² turn your animation into a interactive caleidoscope.
  190.  
  191.      - To experience the digital feedback feature, load one animation,
  192.      press 3 or e and move the mouse. For digital feedback with two
  193.      animations; load two anims, press 3 or e (or 2,4,r,t, etc...)
  194.      and press f. Enhance the feedback effect by activating the
  195.      wipe patterns. You never saw this much garbage without crashing
  196.      your Amiga. PAD 0 will help you to clean the mess.
  197.  
  198.      - Obtain a realtime outline effect by loading the same animation
  199.      twice, press 2 (the image disappears), and press a few times
  200.      on the PAD (2,4,6 or 8) directional buttons.
  201.  
  202.      - To see the effect of the bitplane operators, load an animation
  203.      that has more than two colors, don't move the mouse, freeze the
  204.      animation by pressing the mousebuttons or space bar, press ' to
  205.      lock bitplane #1 and move the mouse. Unlock the bitplane (#1) by
  206.      pressing [.
  207.  
  208. KNOWN BUGS
  209.  
  210.      Sometimes when using Mnu², the filerequesters will seize to
  211.      appear due to an error with the asl.library. A fresh restart
  212.      will solve this problem.
  213.  
  214. HISTORY
  215.  
  216.      The program was originally designed to scroll a huge animated
  217.      image over the screen. While writing, I got addicted to the
  218.      possibilities of the animation playback code, thus Mnu² was born.
  219.      Since then the program developed into an interactive graphic tool
  220.      that's capable of transforming simple animations into a variety
  221.      of different appearances.
  222.  
  223.      Mnu² has been used by Captain Video during their VJ performances,
  224.      where animations were made 'on the fly' to become an intuitive
  225.      part of the live mixed imagery.
  226.  
  227. FUTURE
  228.  
  229.      There are plans for a 3.0 version where I'd like to implement
  230.      AGA animations, colorcycling and sampler sourcecode to make the
  231.      images react to music. Therefore any information about faster
  232.      amiga display and sampler sourcecode is *very* welcome email !
  233.  
  234. AUTHORS
  235.  
  236.      Mnu² is written by Rob Haarsma, with valuable additions from
  237.      Harro Mantel. The animation display code is ripped from Olaf
  238.      'Olsen' Barthel's Mandelsquare² fractal exploration program.
  239.      The animation unpack code is written in assembler by Jim Kent
  240.      (Dancing Flame).
  241.  
  242. VERSIONS
  243.  
  244.      v1.0    Jun 95  buggy command-line version
  245.      v2.1    Jan 97  workbench version
  246.      v2.3    Feb 97  fully debugged version
  247.      v2.4e   Oct 97  hi-res animations reimplemented
  248.      v2.4f   Nov 97  speed optimised version
  249.      v2.4h   Jan 98  code optimised version
  250.      v2.5.0  Jan 98  first public release at www.captainvideo.nl
  251.      v2.5.1  Jan 98  wipe patterns added, Mnu².doc extended
  252.              Jun 98  Mnu² uploaded to aminet (a bit late... sorry !)
  253.  
  254. CONTACT
  255.  
  256.      Contact the authors at:
  257.  
  258.      rob@captainvideo.nl (Rob Haarsma)
  259.      hmantel@cs.vu.nl    (Harro Mantel)
  260.  
  261. Info-Mnu²          Last change: 6 Jun 98 (v2.5.1)                 (1)
  262.  
  263.